package com.smart.community.property.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.smart.community.property.entity.ElectricityFee;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.math.BigDecimal;
import java.util.List;
import java.util.Map;

/**
 * 电费Mapper接口
 * @author Wu.Liang
 * @since 2024-12-21
 */
@Mapper
public interface ElectricityFeeMapper extends BaseMapper<ElectricityFee> {
    
    /**
     * 根据房户ID和计费周期查询电费记录
     * @param householdId 房户ID
     * @param billingPeriod 计费周期
     * @return 电费记录
     */
    ElectricityFee selectByHouseholdIdAndBillingPeriod(@Param("householdId") Long householdId,
                                                       @Param("billingPeriod") String billingPeriod);
    
    /**
     * 根据房户ID获取最新电表读数
     * @param householdId 房户ID
     * @return 电费记录
     */
    ElectricityFee selectLatestReadingByHouseholdId(@Param("householdId") Long householdId);
    
    /**
     * 根据社区ID和支付状态分页查询电费记录
     * @param communityId 社区ID
     * @param paymentStatus 支付状态（0-未支付，1-已支付，2-逾期，3-部分支付）
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 电费记录列表
     */
    List<ElectricityFee> selectPageByCommunityAndStatus(@Param("communityId") Long communityId,
                                                        @Param("paymentStatus") Integer paymentStatus,
                                                        @Param("offset") int offset,
                                                        @Param("limit") int limit);
    
    /**
     * 根据社区ID和支付状态统计电费记录数量
     * @param communityId 社区ID
     * @param paymentStatus 支付状态（0-未支付，1-已支付，2-逾期，3-部分支付）
     * @return 记录数量
     */
    int countByCommunityAndStatus(@Param("communityId") Long communityId,
                                 @Param("paymentStatus") Integer paymentStatus);
    
    /**
     * 根据用户ID查询未支付电费
     * @param userId 用户ID
     * @return 电费记录列表
     */
    List<ElectricityFee> selectUnpaidByUserId(@Param("userId") Long userId);
    
    /**
     * 获取电费统计信息
     * @param communityId 社区ID
     * @param year 年份
     * @return 统计信息
     */
    Map<String, Object> selectStatistics(@Param("communityId") Long communityId,
                                        @Param("year") Integer year);
    
    /**
     * 批量生成电费记录
     * @param communityId 社区ID
     * @param billingPeriod 计费周期
     * @param unitPrice 单价
     * @return 生成数量
     */
    int batchGenerateElectricityFee(@Param("communityId") Long communityId,
                                   @Param("billingPeriod") String billingPeriod,
                                   @Param("unitPrice") BigDecimal unitPrice);
    
    /**
     * 查询异常用电记录
     * @param communityId 社区ID
     * @param minUsage 最小用量
     * @param maxUsage 最大用量
     * @return 异常记录列表
     */
    List<ElectricityFee> selectAbnormalUsageRecords(@Param("communityId") Long communityId,
                                                   @Param("minUsage") BigDecimal minUsage,
                                                   @Param("maxUsage") BigDecimal maxUsage);
} 